home *** CD-ROM | disk | FTP | other *** search
/ The Arsenal Files 8 / The Arsenal Files Collection #8 (Arsenal Computer) (1996).ISO / wildcat / jagnews5.zip / JAGNEWS5.DOC < prev    next >
Text File  |  1996-09-21  |  14KB  |  337 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.           J A G N E W S 5   N E W S L E T T E R   G E N E R A T O R
  7.  
  8.  
  9.        Version 5.0                                    For Wildcat! 5
  10.       ________________________________________________________________
  11.  
  12.        Distributed as Shareware
  13.        (c)1996 Chris Jagger Creative Services 
  14.       ________________________________________________________________
  15.       R e l i a b l e  P r o g r a m s * A w e s o m e  G r a p h i c s  
  16.  
  17.  
  18.  
  19.       Overview
  20.       ----------------------------------------------------------------
  21.       JAGNEWS5.WCX is a Newsletter generator that will  generate  both
  22.       ANSI .BBS and HTML Newsletter displays for your Wildcat 5 BBS!!!
  23.       Both displays are date stamped each time you update them &  both
  24.       displays will be updated with your most CURRENT news first!!!!!!
  25.       JAGNEWS5 uses the standard full-screen WC5 editor to  edit  your 
  26.       news so you can update your Newsletter from a remote location!!!
  27.       Since it uses the WC5 editor,   you can also create all the text
  28.       for the news update OFFLINE, then upload it into the editor when
  29.       running JAGNEWS5!     The graphics in the .BBS\HTML displays are
  30.       A w e s o m e!!!   Another product of CJCS!
  31.  
  32.  
  33.  
  34.       Liability
  35.       ----------------------------------------------------------------
  36.       The author  makes no warranty of any kind, expressed or implied,
  37.       including without limitation,  any warranties of merchantability
  38.       and/or fitness for a particular purpose.  The author will not be
  39.       liable  for any damages,  whether direct,  indirect,  special or 
  40.       consequential arising from  a failure of this program to operate 
  41.       in the manner desired by the user. The author will not be liable 
  42.       for any damage to data or property which  may be caused directly 
  43.       or indirectly by use of the program.
  44.  
  45.       When trying new software,  always  backup any and  all important 
  46.       files on your system.
  47.  
  48.  
  49.  
  50.       Notice
  51.       ----------------------------------------------------------------
  52.       Under no circumstances  is it legitimate for any user  to modify
  53.       or reverse engineer this product. This product is copyrighted to
  54.       the author, who reserves all rights regarding it. 
  55.  
  56.  
  57.  
  58.       Distribution
  59.       ----------------------------------------------------------------
  60.       You  are encouraged to distribute the  Shareware version of this
  61.       program provided all files are unaltered and remain intact. Feel
  62.       free to distribute this program to other Sysops so that they may 
  63.       evaluate this program as well.
  64.  
  65.  
  66.  
  67.       Features
  68.       ----------------------------------------------------------------
  69.       * Offers what Jagger Creative Services is known for....
  70.         A w e s o m e   A n i m a t i o n !
  71.  
  72.       * Easily creates or updates your Newsletter!
  73.       
  74.       * Option to create HTML page along with your ANSI .BBS display!
  75.       
  76.       * Uses the standard Wildcat 5 full-screen editor!
  77.  
  78.       * Update your Newsletter displays from a remote location!
  79.  
  80.       * Allows you to create text for news update offline!!!!!!   Then  
  81.         simply upload the text into the editor when running JAGNEWS5!!
  82.  
  83.       * Date stamp colors of .BBS screen are configurable!
  84.  
  85.       * Creates displays with the most current news first!
  86.  
  87.  
  88.  
  89.       Installation
  90.       ----------------------------------------------------------------
  91.       Here it is in 6 easy steps, are you ready?
  92.  
  93.       1]Unzip the contents of the JAGNEWS5 archive into your Wildcat 5 
  94.         home directory (normally called C:\WC5\).
  95.  
  96.       2]Use wcMenu to modify your Sysop Menu.    All you have to do is
  97.         add a menu key to your Sysop Menu, make this key "Run a wcCode
  98.         program", then choose "JAGNEWS5" from  your  choices of wcCode
  99.         programs to run!  Don't forget to choose "Access" and give the
  100.         Sysop access to JAGNEWS5.
  101.  
  102.       3]Also use wcMenu & set up your  Sysop Menu to run NEWSCFG5.WCX.
  103.         After configuration  you  can remove  NEWSCFG5.WCX  from  your 
  104.         Sysop Menu unless you think you'll reconfigure JAGNEWS5 often.
  105.   
  106.       4]Simply run NEWSCFG5 to set up & configure JAGNEWS5!   NEWSCFG5
  107.         will take you  step by step through the configuration process.
  108.         NEWSCFG5 will:
  109.  
  110.         -ask you the full path and filename of  your  Newsletter  .BBS
  111.          screen.     You will have to enter the FULL  path  (including
  112.          filename) of the .BBS screen that you want created.
  113.  
  114.         -ask you to pick the color that you want the date stamp to  be
  115.          displayed in on the Newsletter .BBS display.
  116.  
  117.         -ask for your Wildcat 5 Home dir path (normally it's C:\WC5\).
  118.  
  119.         -ask if you want an HTML display created!
  120.  
  121.         -create a sub dir called (WC5 home dir)\HTTP\PUBLIC\Jagnews5\.
  122.          This is the dir it will create it's HTML pages in.  Also, the
  123.          3  .gif files will be moved to this directory  when  you  run 
  124.          NEWSCFG5.WCX.  The .gifs are used by JAGNEWS5's HTML page.
  125.  
  126.         If you need to make changes later, simply rerun NEWSCFG5.WCX!
  127.   
  128.       5]Read "Before you run JAGNEWS5" below BEFORE you first run  the
  129.         program.
  130.  
  131.       6]You're done, now run JAGNEWS5!  
  132.  
  133.  
  134.  
  135.       Before you run JAGNEWS5
  136.       ----------------------------------------------------------------
  137.       Make a backup of your Newletter .BBS display screen (normally it
  138.       is called C:\WC5\DISP\NEWSLTR.BBS ).   This is just in case, for
  139.       any reason, you don't like our displays.     There are 2 ways to
  140.       first run the program so that it displays correctly,   make SURE 
  141.       that you strictly follow one of the 2 methods below:
  142.  
  143.       Method 1 - (Easiest and it's recommended) Run JAGNEWS5 and  then
  144.       choose "[B]egin new Newsletter".     This starts your Newsletter
  145.       from scratch.   That's it!    You'll go right into the editor to
  146.       edit the first news update to your NEW Newsletter!!!  Note,  you
  147.       can choose [B]egin.. ANYTIME you want to start a NEW Newsletter!
  148.  
  149.       Method 2 -if you currently have anything in your Newsletter that
  150.       you still want displayed then do this:
  151.       With wcDraw, take out all @CLS@ and @-codes from the top of your
  152.       Newsletter!  Insert 5 lines at the top & type something in  each
  153.       line (it doesn't matter what, just as long as they are not  left
  154.       blank).  Run JAGNEWS5 and choose "[A]dd to Newsletter".     This
  155.       will add your NEW JAGNEWS5 news on top of your old Newsletter!!!
  156.       Do NOT choose  "[B]egin a new Newsletter"  unless  you  want  to
  157.       clear your .BBS display & start your Newsletter from scratch. If
  158.       you have any trouble with this method of first starting JAGNEWS5
  159.       then simply switch to Method 1 above, it's much easier!
  160.  
  161.  
  162.  
  163.       Start a New Newsletter at Anytime
  164.       ----------------------------------------------------------------
  165.       The menu choice "[B]egin a new Newsletter" can be  used  ANYTIME
  166.       to clear the .BBS/HTML displays and start your  Newsletter  from 
  167.       scratch!!    
  168.  
  169.  
  170.  
  171.       Create Your Newletter Updates OFFLINE
  172.       ----------------------------------------------------------------
  173.       The editor that JAGNEWS5 uses when you choose to "[A]dd to....."
  174.       or "[B]egin new..." is WC5's standard full-screen editor.    So,
  175.       you can create the news update text OFFLINE, run JAGNEWS5,  then
  176.       choose to "[A]dd.." or "[B]egin...",   then once your in the WC5
  177.       editor hit the ESC key and hit "U" to upload your text into the
  178.       editor!
  179.  
  180.  
  181.  
  182.       The WC5 Full-Screen Editor
  183.       ----------------------------------------------------------------
  184.       When you're editing your Newsletter,  JAGNEWS5 uses the standard  
  185.       WC5 full-screen editor.  Most of the options ARE used, including
  186.       [S]ave,  [C]ontinue,  [Q]uit,  [H]elp,  [V]iew,  [L]ine  editor, 
  187.       S[p]elling, and [U]pload.   However, since your are NOT actually
  188.       sending any message  with  the  editor  (you're just editing the 
  189.       Newsletter displays) the following editor options are  NOT used:
  190.  
  191.       Su[b]ject - 
  192.       You can change it but it won't  matter  because  NO  message  is
  193.       being sent, you're just editing the Newsletter displays!
  194.  
  195.       Car[r]bon -
  196.       Once again, no need to use this since NO message is being sent!!
  197.  
  198.       Quo[t]e -
  199.       Once again, no need to use this since NO message is being sent!!
  200.       
  201.       [A]ttach-
  202.       Once again, no need to use this since NO message is being sent!!
  203.  
  204.       Note, the most important editor  option  that  CAN  be  used  is
  205.       [U]pload!!!!!    This will allow you to create Newletter updates 
  206.       OFFLINE, then upload them into the editor!
  207.  
  208.  
  209.  
  210.       HTML Output Path
  211.       ----------------------------------------------------------------
  212.       JAGNEWS5 will create it's HTML page,  called NEWS.HTM,   in  the
  213.       (WC5 home dir)\HTTP\PUBLIC\Jagnews5\ subdirectory.    The 3 .gif
  214.       files included with this archive MUST also be in this subdir for
  215.       the HTML page to display properly.   You can leave NEWS1.GIF out
  216.       of this subdirectory if you would rather the  NEWS.HTM  page  be
  217.       displayed with a white background, however you  must  NOT  leave
  218.       NEWS2.GIF or NEWS3.GIF out of this JAGNEWS5 subdirectory.
  219.  
  220.  
  221.  
  222.       What Are HTML Pages
  223.       ----------------------------------------------------------------
  224.       Hyper Text Markup Language is the language of the Internet.  Web
  225.       browsers (Netscape, Mosaic, etc.) can display text and images by 
  226.       using the HTML language. Wildcat5 features a graphical interface 
  227.       that also uses HTML pages.   This program creates HTML pages for
  228.       use with Wildcat 5!
  229.  
  230.  
  231.  
  232.       Adding JAGNEWS5'S Newsletter HTML Page To Your WC5 Home Page
  233.       ----------------------------------------------------------------
  234.       If you opt to create the JAGNEWS5 Newsletter HTML  page,  called
  235.       NEWS.HTM,  then you can create a link to it from your  WC 5  BBS
  236.       home page by using the following line of HTML code:
  237.  
  238.       <A HREF="/public/Jagnews5/News.htm">Newsletter</A><P>
  239.  
  240.       That's all there is to it!!!   See your Wildcat 5 manual for any
  241.       further instructions on creating links from your WC5 home page.
  242.  
  243.  
  244.  
  245.       Important Note
  246.       ----------------------------------------------------------------
  247.       All log files, configuration files, and key files for registered
  248.       users will be located in your WC5 data directory (normally it is                                                  
  249.       called C:\WC5\DATA\).  This is so these files would  NOT clutter 
  250.       up your Wildcat 5 home directory.
  251.  
  252.      
  253.  
  254.       A Note on wcRun
  255.       ----------------------------------------------------------------
  256.       Both JAGNEWS5 & NEWSCFG5 are loaded with graphics  that  do  NOT
  257.       display correctly if run with "wcrun -r"!!!!     Considering the
  258.       animated graphics that they use,   these programs were meant for
  259.       ONLINE use only and not to be run with the "wcrun -r" command.
  260.  
  261.  
  262.  
  263.       Packing List
  264.       ----------------------------------------------------------------
  265.       The  following files should be included in the original archive.
  266.       DESC.SDI.......This is the description file
  267.       FILE_ID.DIZ....This is the description file
  268.       JAGNEWS5.DOC...This is the .DOC that you're reading now
  269.       JAGNEWS5.WCX...This is the MAIN PROGRAM FILE
  270.       NEWS1.GIF......Used by JAGNEWS5's HTML (\HTTP\PUBLIC\JAGNEWS5\ )
  271.       NEWS2.GIF......Used by JAGNEWS5's HTML (\HTTP\PUBLIC\JAGNEWS5\ )
  272.       NEWS3.GIF......Used by JAGNEWS5's HTML (\HTTP\PUBLIC\JAGNEWS5\ )
  273.       NEWSCFG5.WCX...This is the configuration .WCX for easy setup
  274.       REGISTER.DOC...This file contains the registration form
  275.       WHATSNEW.DOC...This is the history file for this program
  276.  
  277.       If any of these files are missing,  please do not distribute, or
  278.       use this program.   Contact the MSI HQ BBS at 805-873-2400 for a
  279.       copy of the latest version.
  280.  
  281.  
  282.  
  283.       H e l p f u l   H i n t s
  284.       ----------------------------------------------------------------
  285.       If used,NEWS1.GIF,NEWS2.GIF,& NEWS3.GIF must be in your JAGNEWS5
  286.       directory (normally it's C:\WC5\HTTP\PUBLIC\JAGNEWS5\ ).
  287.  
  288.       If you ever run into any display problems,   especially when you 
  289.       FIRST run JAGNEWS5, then try choosing "[B]egin new Newsletter"!!
  290.       This starts the Newletter .BBS\HTML displays from scratch!
  291.  
  292.       Once you install JAGNEWS5 and you start updating your Newsletter
  293.       displays, NEVER use wcDraw and manually edit your Newsletter and
  294.       NEVER manually change your NEWS.HTM page.   Only use JAGNEWS5 to
  295.       update them.  The reason why is JAGNEWS5 uses  the  structure of
  296.       these displays to know where your look for your old news & where
  297.       to place new news.      If you manually change anything then the
  298.       program will not update the Newletter correctly.
  299.  
  300.       NEVER use any @-codes in your news updates  when  your  updating 
  301.       your Newsletter with JAGNEWS5'S editor!  The colors & everything
  302.       are already configured so you won't need any @-codes.
  303.  
  304.       If you use Jagger's "Newuser" wcCode  program, JAGNEW5, then  be
  305.       careful not to get it mixed up w/ this program, JAGNEWS5, during
  306.       setup since they do bear similar names!
  307.  
  308.      
  309.  
  310.       Aknowledgements
  311.       ----------------------------------------------------------------
  312.       Thanks to all beta testers of Jagger's v5 wcCode.    A heartfelt
  313.       thanks to the countless folks that  have  registered & supported 
  314.       our wcCode programs over the years.   We will  always  strive to
  315.       create wcCode that will bring out the most in your BBS system.
  316.  
  317.  
  318.  
  319.       Support
  320.       ----------------------------------------------------------------
  321.       You can reach Jagger Creative Services by e-mailing  John Tilley
  322.       on the MSI HQ BBS (1-805-873-2400).
  323.  
  324.       All comments and recommendations are welcome!
  325.  
  326.  
  327.  
  328.       Registration Information
  329.       ----------------------------------------------------------------
  330.       Please see the REGISTER.DOC included with this Zip File.
  331.  
  332.  
  333.  
  334.       Thanks for trying JAGNEWS5!
  335.  
  336.       Chris Jagger
  337.